-- *****************************************************************
-- CISCO-VOA-MIB.my
--
-- May 2002, Sonal Maheshwari, Mickey Spiegel
--
-- Copyright (c) 2002 by cisco Systems, Inc.
-- All rights reserved.
-- *****************************************************************CISCO-VOA-MIB DEFINITIONS::=BEGINIMPORTSMODULE-IDENTITY,OBJECT-TYPE,Integer32FROM SNMPv2-SMI
TEXTUAL-CONVENTION,TimeStampFROM SNMPv2-TC
MODULE-COMPLIANCE,OBJECT-GROUPFROM SNMPv2-CONF
ifIndex FROM IF-MIB
OpticalIfDirection FROM CISCO-OPTICAL-MONITOR-MIB
ciscoMgmt FROM CISCO-SMI
;ciscoVoaMIB MODULE-IDENTITYLAST-UPDATED"200205070000Z"ORGANIZATION"Cisco Systems, Inc."CONTACT-INFO"Cisco Systems
Customer Service
Postal: 170 W Tasman Drive
San Jose, CA 95134
Tel: +1 800 553-NETS
E-mail: cs-dwdm@cisco.com"DESCRIPTION"This MIB module defines objects to configure and manage the
Variable Optical Attenuator (VOA) modules.
VOA modules are typically used to attenuate channels added
by a network element, in order to equalize the input power of
each wavelength before the multiplexed signal consisting of
all wavelengths is sent through an EDFA. There may be
a separate VOA per channel, one VOA per band of wavelengths,
or one VOA for the pass through wavelengths.
VOA modules are also often used before terminating optical
wavelengths at optical receivers, in order to avoid receiver
saturation.
The VOAs may be present on various modules within the network
element, for example, on an Optical Add/Drop Multiplexer
(OADM) module, on the same module as an optical transceiver,
or on a separate module of its own.
"REVISION"200205070000Z"DESCRIPTION"The initial revision of this MIB."::={ ciscoMgmt 262}-- Textual ConventionsOpticalPowerInDbm ::=TEXTUAL-CONVENTIONSTATUScurrentDESCRIPTION"An integer value that gives the optical power level in 1/10ths
of dBm.
Example: The value -300 represents a power level of -30.0 dBm.
The distinguished value of '-1000' indicates that the object
has not yet been initialized.
"SYNTAXInteger32(-400..250 | -1000)OpticalAttenInDb ::=TEXTUAL-CONVENTIONSTATUScurrent
DESCRIPTION"An integer value that gives the attenuation level in
1/10ths of dB.
Example: The value 80 represents an attenuation
level of 8.0 dB.
"SYNTAXInteger32(0..400)-- MIB Object DefinitionscVoaMIBObjects OBJECTIDENTIFIER::={ ciscoVoaMIB 1}-- groups in this MIB modulecVoaBaseGroup OBJECTIDENTIFIER::={ cVoaMIBObjects 1}-- VOA basic objectscVoaTable OBJECT-TYPESYNTAXSEQUENCEOF CVoaEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"This table provides objects to configure and control the
attenuation on VOAs."::={ cVoaBaseGroup 1}cVoaEntry OBJECT-TYPESYNTAX CVoaEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"An entry in the cVoaTable provides objects to configure and
control the attenuation level of a VOA at an interface, for
a given direction."INDEX{ ifIndex, cVoaDirection }::={ cVoaTable 1}
CVoaEntry ::=SEQUENCE{
cVoaDirection OpticalIfDirection,
cVoaAttenuationControlMode INTEGER,
cVoaAttenuation OpticalAttenInDb,
cVoaAttenuationLastChange TimeStamp,
cVoaDesiredPower OpticalPowerInDbm
}cVoaDirection OBJECT-TYPESYNTAX OpticalIfDirection
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"This is the second index into the cVoaTable and indicates
the direction for which the attenuation level at this
interface is being controlled, in this entry."::={ cVoaEntry 1}cVoaAttenuationControlMode OBJECT-TYPESYNTAXINTEGER{manual(1),automatic(2)}MAX-ACCESSread-writeSTATUScurrentDESCRIPTION"This object is used to set the mode of controlling the
attenuation level of a VOA at an interface.
When the mode is set to 'manual', the attenuation level is
configured manually, by setting the desired attenuation
level in the cVoaAttenuation object. The cVoaDesiredPower
object does not apply in this case.
When the mode is set to 'automatic', the attenuation level
is continuously adjusted to maintain a desired power level,
after attenuation. The desired optical power level after
attenuation is configured using the cVoaDesiredPower object.
The cVoaAttenuation object cannot be configured in this case,
but it indicates the attenuation level derived from the
desired power level.
The automatic mode of controlling attenuation should not be
used when the monitored power level includes multiple
wavelengths, since the power level monitor cannot distinguish
between a decrease in power across all wavelengths, versus a
loss of power of some but not all wavelengths. If some but not
all wavelengths go down, this would cause the attenuation level
to be automatically decreased, leading to an increase in the
power level of the remaining wavelengths."::={ cVoaEntry 2}cVoaAttenuation OBJECT-TYPESYNTAX OpticalAttenInDb
MAX-ACCESSread-writeSTATUScurrentDESCRIPTION"This object indicates the attenuation level applied at the
interface.
When the cVoaAttenuationControlMode object is set to 'manual',
the attenuation level may be specified by setting this object."::={ cVoaEntry 3}cVoaAttenuationLastChange OBJECT-TYPE
SYNTAXTimeStampMAX-ACCESSread-onlySTATUScurrentDESCRIPTION"This object indicates the value of sysUpTime at the last
time the attenuation level was adjusted at this interface,
in the given direction."::={ cVoaEntry 4}cVoaDesiredPower OBJECT-TYPESYNTAX OpticalPowerInDbm
MAX-ACCESSread-writeSTATUScurrentDESCRIPTION"This object indicates the desired optical power level,
after attenuation, at the interface.
This object applies only when the cVoaAttenuationControlMode
object is set to 'automatic'. In this mode, the attenuation
level is continuously adjusted to maintain the desired
power level, after attenuation, as specified by this object."::={ cVoaEntry 5}-- MIB Conformance StatementscVoaMIBConformance OBJECTIDENTIFIER::={ ciscoVoaMIB 3}cVoaMIBCompliances OBJECTIDENTIFIER::={ cVoaMIBConformance 1}cVoaMIBGroups OBJECTIDENTIFIER::={ cVoaMIBConformance 2}
cVoaMIBCompliance MODULE-COMPLIANCESTATUScurrentDESCRIPTION"The compliance statement for platforms that provide
configuration and control of VOA modules."MODULE-- this moduleMANDATORY-GROUPS{ cVoaMIBBaseGroup }::={ cVoaMIBCompliances 1}-- Units of ConformancecVoaMIBBaseGroup OBJECT-GROUPOBJECTS{
cVoaAttenuationControlMode,
cVoaAttenuation,
cVoaAttenuationLastChange,
cVoaDesiredPower
}STATUScurrentDESCRIPTION"A collection of mandatory managed objects that provide basic
configuration and control of the VOA modules."::={ cVoaMIBGroups 1}END